home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr36
/
catlist.zip
/
CATLIST.MAN
< prev
next >
Wrap
Text File
|
1993-04-26
|
26KB
|
517 lines
╓──────────────────────────────────────────────────────────────╖
║╓────────────────────────────────────────────────────────────╖║
║║┌─────┐ ┌──────┐ ┌─────┐ ┌─┐ ┌───┐ ┌─────┐ ┌─────┐║║
║║│ ┌─┐ │ │ ┌──┐ │ └─┐ ┌─┘ │ │ └┐ ┌┘ │ ┌───┘ └─┐ ┌─┘║║
║║│ │ └─┘ │ └──┘ │ │ │ ┌────┐ │ │ │ │ │ └───┐ │ │ ║║
║║│ │ ┌─┐ │ ┌──┐ │ │ │ └────┘ │ │ │ │ └───┐ │ │ │ ║║
║║│ └─┘ │ │ │ │ │ │ │ │ └──┐ ┌┘ └┐ ┌───┘ │ │ │ ║║
║║└─────┘ └─┘ └─┘ └─┘ └────┘ └───┘ └─────┘ └─┘ ║║
║╙────────────────────────────────────────────────────────────╜║
║ ║
║ A WILDCAT! Specific BBS Listing Program ║
║ Copyright 1992-93, PAROLE Software ║
║ ALL RIGHTS RESERVED ║
╙──────────────────────────────────────────────────────────────╜
Dennis N. Maidon
The Parole Board BBS
311 Buffalo Rd
Clayton, NC 27520
(919) 965-3600 -> Voice
(919) 965-9885 -> FAX
The Parole Board BBS
(919) 965-4696 -> US Robotics Dual Standard
Free Advice BBS
(919) 934-1002 -> US Robotics HST
--------------------------
Now with RIP! Graphic bulletins.
--------------------------
CatList is a BBS Listing door written specifically for Wildcat! BBS
3.x and greater. With v2.1, CatList should support TriBBS and Spitfire.
This is untested. I do not imply in any shape, form or fashion that
CatList will operate on any other BBS software. CatList will maintain a
BBS list for a specified number of days. At the end of that time, the
user that listed the BBS will receive a notice for 10 days informing
him/her that the listing has expired and must be updated. On the
eleventh day if the user has not updated the listing, it will be deleted
from the database. CatList notifies the user that the listing was
deleted. All notifications are sent using the USERxxx.BBS files which
WildCat! sends to the individual user when they logon. Once this file is
sent, WC! then deletes the file and logs it to the Activity.log.
CatList supports COMs 1-4 only. It will also support COMs 5-8 with the
addition of a FOSSIL driver.
Only the user that originally listed a BBS will be able to
Edit/Update or Delete that listing. You as the sysOp have the ability
to E/U/D any listing in the database.
The door should be easy enough to set up on its own, particularly if
you're familiar with door operation under Wildcat! If you do have any
problems, you can reach me on The Parole Board BBS or you can call me
voice.
REGISTERED OPTIONS:
Once registered, you may set the Listing Age (Line #7 of the CFG
file) to any number of days. Until registration, it is locked at 14
days. I do not like 'crippling' or 'handicapping' one of my programs
but on my older doors, there are more un-registered users using them
than registered. Registered SysOps also have the ability to use
HEADER.DAT and TAIL.DAT files. These are ASCii text files that are
added to the TEXT file that is created by CatList. You may use them for any
reason that you desire. The HEADER.DAT is written to the text file just
after the Copyright Info and before the body of the listings. The
TAIL.DAT is written just after the body of the listings and before the
credits. The files must be named "HEADER.DAT" & "TAIL.DAT".
Registered SysOps may also create a header file called "SPECHDR.DAT"
that will be used in the "Spec File" that is created. This file may be
configured by the SysOp to contain a specific number of listings. Some
may prefer to use this file as a HELLOx.BBS or GOODBYE.BBS file.
SysOps that would like to use POSTMASTER (Copyright 1992, Dave Cody &
BoardWalk Software) have the option of setting Line 12 of the CFG file
to "Y". CatList will then create two files named "CATLIST.EXP" and
"CATLIST.DEL" in the WC! home directory that you specified on line 10 of
the CFG file. CATLIST.EXP contains the names of the users that have
EXPIRED listings. The CATLIST.DEL contains the names of users with
listings that have been deleted. These files are ONLY created once each
day when the maintenance is performed. You may want to add a couple of
lines to your DOORx.BAT to test for these files and have POSTMASTER work
on them. CatList is fully functional other than these options.
If you do not like the list of BBS softwares that are hardcoded into
Catlist, you may create a file named "SOFTWARE.CL" and place it into the
door directory. CatList will look for this file and use that list
instead of the hardcoded BBS softwares. See the enclosed "SOFTWARE.CL"
for the file format. It *MUST* contain exactly 28 lines. Each software
type may be a maximum of 8 characters. That fits "WildCat!" exactly.
<grin> The modem types may also be changed through the "MODEM.CL" file.
This file must also be located in the door directory. It contains 14
lines with a maximum of 25 characters per line. You may delete either
or both of these files if you prefer to keep the defaults in CatList.
Users may also download the CATLIST.TXT file via the door. To utilize
this option, you will need a copy of DSZ/GSZ.EXE. You will need to
create a CFG file named "DSZCFG.x" (x=Node Number).
DSZ <-Line 1
2F8,3 <-Line 2
=========================================================================
This file requires *ONLY* 2 lines. I have included the instructions
here to enable you to locate them a bit easier.
There are NO changes to the CFG file, however; there has
been a file added. With this release, users that enter
an event may also upload an ANSI display screen. This
will require creating a file named "DSZCFG.x", with the
"x" being the node number. If you have more than 1
node, you must create a file for each node. The format
is as follows:
Line 1: "DSZ" or "GSZ" (without the quotes) Place the
filename of whichever program you use.
Line 2: You will need to enter the BASE,IRQ of the node
you are operating on here. For example, If you
are using COM2, you should place "2F8,3" on
this line. See the enclosed DSZCFG.1 for a
sample.
COM1 3F8,4 ─┐ Standard
COM2 2F8,3 ─┘
COM3 3E8,<IRQ> ─┐Put correct IRQ number
COM4 2F8,<IRQ> ─┘instead of <IRQ>
You should read the DSZ/GSZ documentation and the
X00.SYS DOCs for further details. You should also have
DSZ.COM or GSZ.COM located in a directory that is in
your path. Users will be given a choice of ZMODEM,
XMODEM, XMODEM-1K, XMODEM-CRC, YMODEM and YMODEM-1K. I
wholeheartedly recommend that you register DSZ or GSZ
from Chuck Forsberg if you intend to use it.
SUPPORT:
Support for CatList is available from several sources. Messages
may be left on The Parole Board BBS in the "PAROLE Software" conference
or the Mustang! BBS in the "PRIVATE" conference. If you feel that a
message is not satisfactory you may call me voice. (919) 965-3600
Please call before 9:30pm EST as I am an early riser and need to get my
"beauty sleep".
NOTE: *PLEASE* check your file name and paths very carefully. Ninety
percent of the calls I get, are due to an incorrect path or CFG file
setup. Read the following instructions carefully before calling.
UPDATES:
Updates are FREE to registered users and may be downloaded from The
Parole Board BBS, Mustang! BBS and various other BBS systems. Once
registered, CatList updates are free for life. If you wish an update on
disk, send $3 to the address listed above and specify the disk size.
If you are in a hurry and do not want to take the time to logon,
enter " PAROLE SOFTWARE NOW! " at the name prompt. It will give you
access to the PAROLE Software file & support areas. Don't forget the
"!" on "NOW".
---------------
The following files are *ONLY* available for download to REGISTERED
Sysops of any PAROLE Software door. If don't have access to the
"Registered Software" conference, leave me a message with the name(s) of
the doors you have previously registered.
CL-UTIL.ZIP This utility allows you to reset the last update of each
record on the CatList database.
----------------
LEGALITIES
__________
THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
WITHOUT WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT
LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
OR BREACH OF ANY WARRANTY.
DISTRIBUTION
____________
You may make this file available for downloading from your BBS or you may
upload it to any BBS of your choice, provided that you do not make any
changes to the contents of the archive (ZIP file). The archive and its
individual contents may not be used by any service that charges any money
whatsoever, without the written permission of the author.
This ZIP file was created using the -AV function of PKZIP. If
my AV is missing then this file may not be complete or has been
tampered with. Complete and current editions of this program
are always available for D/L on The Parole Board BBS. If the -AV
is missing please complain to your sysop to stop the practice of
removing AV's as this is your assurance from the programmer that
the file is complete and virus free.
INSTALLATION:
Installation of CatList is an easy straightforward operation. You
will need to create a directory to hold the CatList files. For
simplicity, we will use the directory "C:\DOOR\CATLIST" in this
documentation. Once you have created "\CATLIST", unZIP the CATLISTx.ZIP
archive into that directory. Create a sub directory named "\AFILES".
The ANSI BBS ads will be ULed to this directory. You should then create
a sub directory called "C:\DOOR\CATLIST\SCREENS". UnZIP the file
"SCREENS.ZIP" into this sub-directory. SCREENS.ZIP should contain the
following files:
instruct.ans ─┐ User Instructions
instruct.asc ─┘
menu.ans ─┐
menu.asc │
menu2.ans │ Main Menu
menu2.asc │
menunew.ans │
menunew.asc ─┘
vscreen.ans ─┐ View system Stats Screen
vscreen.asc ─┘
welcome.ans ─┐ Opening Welcome Screen
welcome.asc ─┘
Any of these screens may be modified by the user but with some
restrictions. The MENU.xxx, VSCREEN.xxx, and WELCOME.xxx screens must
remain the same physical size since some of the info on them is
hard coded in the CATLIST.EXE program.
MSGIMP.ZIP contains sample .IMP files that you may modify to suit
your individual tastes. Place these files where you normally place
your .IMP files. This should be in your \WC30\MSG directory. The
archive should contain the files "DELETE.IMP" and "EXPIRE.IMP".
You will then need to edit the CATLIST.CFG file(s) to suit your
individual WildCat! setup. You MUST use an ASCii editor to edit the CFG
file at all times. Some word processors leave hidden control codes that
could cause CatList to die a horrible and ugly death. The CATLIST.CFG
file must contain 15 lines. Make sure that the lines in the CFG file
that require a "^" switch have them. If you get an "Overflow error" or
and "Illegal function call" then you have probably left one of the
switches off.
C:\WC30\WCWORK\NODE1\USERINFO.DAT <- Path to User file
The Parole Board BBS <- BBS Name
Dennis <- SysOp's first name
Maidon <- SysOp's last name
12345 <- Registration Serial number
100 <- Min. Sec level to access door
260 <- Min Sec lev to Add listings
30 <- Number of days to maintain listing
E:\TEXT\TPB-LIST.TXT^L <- Path to create text file and
switch to determine the type of
text file you want created.
"^S" = Short Listing
"^L" = Long Listing
One of these switches *MUST* be
present.
RIP <- "RIP" = RIP Bulletin "N" = No RIP
C:\WC30\BULL\BULL35.BBS^Y <- Path to create COLOR bulletin &
@pause@ switch
C:\WC30\ <- Your HOME dir - ACTIVITY.xxx log
C:\WC30\DISP <- Path to your display files
Y <- (Y/N) Create files needed by POSTMASTER
This option is only available to
registered users but, this line
must still be included in the CFG
file.
C:\WC30\DISP\GOODBYE.SCR^Y <- REGISTERED USERS ONLY FEATURE
This line *MUST* be included in
the CFG file whether you have
registered CatList or not.
CatList will now create a special
color file that contains a
specified number of listings from
the database. I've had several
request this feature so that
they may use it as a GOODBYE.BBS
screen. If you want to disable
this feature, place "[N]" on this
line. If it is disabled, you may
leave off the next line. The
"^Y" will append a @pause@ to the
special file. If you do not want
the pause, add "^N" to this line.
One of these switches *MUST* be
used if you do not disable the
special file creation.
5 <- Number of listings in the Special
file. If you've disabled the
feature, you may leave this line
out of the CFG file.
Line 1 This is where CatList will look to find USERINFO.DAT. It MUST
always point to the NODEx directory and NOT the \WC30
directory. DOOR.SYS will also work here but, I strongly
recommend that you use USERINFO.DAT.
Line 2 Your BBS name
Line 3 Your First Name or the name you go by on the BBS (DO NOT use
"SYSOP")
Line 4 Your last name
Line 5 When you register CatList you will be given a serial number.
Place it on this line. Until then, you may put any number you
desire here or leave it blank.
Line 6 This is the minimum security level that you will allow to
enter the door. DO NOT use the Security Name In makewild.
Always use the Menu Access number.
┌──────────── MISCELLANEOUS ────────────┐
│ Menu access level 150 │<- Use this Number from the
│ Menu display set 6 │ EDIT PROFILE SCREEN in
│ Daily time limit 120 │ MAKEWILD. The cotton-picker
│ Maximum logon time 60 │ won't work if you use the
│ Maximum up/down ratio 50 │ Security Profile NAME.
│ Maximum daily downloads 15 │ Trust Me, I've been there.
Line 7 This is the minimum security level that may Add, Edit, Delete
or Update listings. Same procedure as Line 6
Line 8 This is the number of days that a BBS listing will remain current.
If you specify "45" here, all listing will remain valid for 45
days. At that time a notice will be sent to the LISTER that his
listing has expired and that it will be deleted in 10 days. He
will receive a notice each day for the 10 days. On the eleventh
day, if the listing has not been updated, it will be deleted from
the database. There is no way to recover the listing once it has
been deleted. Users are notified by using the "USERxxxx.BBS" files
in the Display directory. These files are deleted by Wildcat! once
they have been sent to the user. The first person to enter the door
each day causes the program to run the maintenance and update
routines.
Line 9 This line contain the path and name of the text file that you
want CatList to create. This file contains no color codes and
is paginated for a printer. This file is similar to the
WCLIST.TXT file that the List door on Mustang! BBS creates.
<G> You may also specify the type of listing you want created.
"^S" = Short Listing (no description)
"^L" = Long listing (full description)
Line 10 CatList supports RIP graphics in that it will create a RIP
bulletin. Place "RIP" on this line if you support RIP and
wish CatList to create a RIP bulletin. Place a "N" to disable
this function.
Line 11 This is the path and name of the COLOR bulletin that you want
created. This bulletin is created using WC!3.x color codes
and MUST have a ".BBS" filename extension. You may also prefer
a HELLOx.BBS screen though the file could get a bit large in
due time. You can also set the default for the @pause@ at the
end of the bulletin. At the end of the bulletin use a "^" as
the spacer and place either a "Y" or "N". One of them *MUST*
be there for the program to work properly.
Line 12 Path where CatList will find you ACTIVITY.xxx files. This is
your Wildcat! home directory. CatList writes to the
individual Activity logs so that you can keep tabs on what
happens in the door.
Line 13 This is the path to your Display directory. Catlist will
write the USERxxxx.BBS file in this directory.
Line 14 (Y/N) If this line is set to "Y" then Catlist will create the
CATLIST.EXP & CATLIST.DEL files that are needed by POSTMASTER.
This option is only available to registered users but, this
line must still be included in the CFG file.
Line 15 REGISTERED USERS! This line must be included in the CFG file
for CatList to operate. If you want to disable it, place a
"[N]" on this line. CatList will now create a color display
file with only a specified number of listings from the
database. The number of listings in the file is controlled by
line 15. "^Y" = @pause@ "^N" = no pause. If CatList finds
the file, "SPECHDR.DAT", it will append this to the special
file that is created. Be sure to add the color codes that you
want in this header so that it will match the bulletin.
Line 16 Number of listings to be included in the Special file on line
14.
Make sure that all your CFG files contain 15 lines. If you are
operating a Multi-Node setup, you must have a separate CFG file for
each node. Each CFG file mus also have unique name such as:
BBS1.CFG BBS2.CFG BBS3.CFG
---------------
NOTE: You may now use one (1) CFG file for multi-node by using the
environment variables.
When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:
PCBoard:
USERS.SYS in C:\PCB - %pcbdrive%%pcbdir%\USERS.SYS
USERS.SYS in C:\PCB\NODE1 - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
Wildcat!:
USERINFO.DAT in C:\WC30\WCWORK\NODE1 - C:\WC30\WCWORK\NODE%WCNODEID%
Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch that runs the door. For example:
SET PCBDRIVE=C:
SET PCBDIR=\BBSDIR
SET PCBNODE=1
--------------
Create the CFG file(s) for you particular BBS. You will also need a DOORx.BAT
to run the door. This one is simple.
@ECHO OFF
CD \DOOR\CATLIST
CATLIST BBS.CFG /5
──┬─
┌──────────────┘
└ If you are running non-Standard Com ports on your BBS, you will need to pass
the proper IRQ to the door. It doesn't hurt to pass the IRQ even if they are
standard. If a user enters the door and it just sits there acting sort of
stupid, it's probably looking for the correct IRQ. Always pass it on the
command line and there will be no question. Some networks have a problem
using the "/" symbol. CatList will now accept an asterisk "*" in place of
the "/". You may also use the environment variable in the DOORx.BAT file to
pass info to the door.
CATLIST BBS%WCNODEID%.CFG /%WCIRQID%
Make sure you DO have the variables set if you use this method.
NOTE: CatList supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
number after the configuration filename. Let's assume your Door is
called FOOBAR and you want to use COM1 and IRQ5. The command line
passed to your Door would be:
FOOBAR FOOBAR.CFG /5
FOOBAR FOOBAR.CFG *5
The /5 tells CatList to use IRQ5 rather than the standard IRQ4 that
is normally used with COM1. No /x parameter is needed for the standard
IRQ's. CatList supports IRQs 1 - 15.
Fossil Driver Support
---------------------
CatList supports the use of Fossil drivers. To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
MYDOOR MYDOOR.CFG /FD
MYDOOR MYDOOR.CFG *FD
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, CatList will print a message to that effect and exit
the door gracefully.
If you have WC! set up to TERMINATE on Doors, you will need to add a
line to reload the BBS. I'm not sure about the exact way this is
set up since I do not use this method. Check your WC! Manual.
Wildcat! will pick up the [G]oodbye from the door as a normal
logoff. It is possible that Livecat! will see this as a Drop
Carrier and not pass it to WC! as a normal logoff. No damage is
done.
CREDITS:
Wildcat! BBS is Copyright 1985-1992, Mustang Software Inc.
PostMaster is Copyright 1992, Dave Cody and BoardWalk Software
CatList was written using the DoorFrame Door module for MicroSoft's
Visual Basic for MS-DOS, Professional Version.
DoorFrame is Copyright 1990-1992, Ted Freeman
Visual Basic for MS-DOS is Copyrighted by Microsoft Corporation.
The ßeta Team [W]ho's Who:
Mike Shockley Shock Treatment Garland, TX (214) 495-5980
Lee Fisher The LOST BBS Overland Pk., KS (913) 642-0349
Steve Sambor Land of the Unicorns Bronxville, NY (914) 961-0399
Craig Dunstan TranScan BBS Topeka, KS (913) 266-0781
Ned Attayek Free Advice BBS Smithfield, NC (919) 934-1002
Herb Dunn The Dew Drop Inn Bakersfield, CA (805) 322-5587
Tom Lamere The Petting Zoo Phoenix, AZ (602) 992-0019
Alan Bennett Terminal Entry Rockingham, NC (919) 895-0368
Without the time and effort that was spent by the preceding BETA
team members, CatList would not have been possible.
Also, a special thanks to all of you that have called with
suggestions for CatList.
DSZ / GSZ Copyright Chuck Forsberg